home *** CD-ROM | disk | FTP | other *** search
/ Aminet 5 / Aminet 5 - March 1995.iso / Aminet / comm / cnet / lgc_g130.lha / Galledis.doc < prev    next >
Text File  |  1994-10-03  |  16KB  |  408 lines
  1.                             __               ____
  2.  ._________. .____________ /_/\ _____________\   \ ____________. ._________.
  3.  |         | |             \_\/               \___\            | |         |
  4.  |.       /\_|__    __/\________  ____________/\  /    /\______|_|_       :|
  5.  ||    _ /  \   \___\/  \       \/\           \ \/____/  \         \ _    ||
  6.  |:    //   /\___\   \  /\_______\ \___________\/\    \  /\_________\\    O|
  7.  |o   . \  /.    /____\// \__   __\/   ________// \____\/. \________/ .   :|
  8.  |.      \//    /     /.    /    ///    /     /o       //   /_____\       .|
  9.  |        \_________ /\__________/\_________ /_______ /\_________ /        |
  10.  |         | |     \/                      \/   __  \/         |\/        .|
  11.  |_________| |________________________________ /\_\ ___________| |_________|
  12.  :         : :                                 \/_/_           : :    Sk!n :
  13.  
  14.  
  15.                       =C=N=E=T= =I=N=N=O=V=A=T=I=O=N=
  16.  
  17.                                 presents...
  18.  
  19.                          -:>> Galledis v1.30 <<:-
  20.               Makes AmiExpress' Local Upload possible on CNet
  21.                    Or: How to ease putting Files online
  22.                           (C) 1994 by Fate/Logic
  23.                        Release Date: 3 October 1994
  24.  
  25.  
  26. CONTENTS
  27. ========
  28.  
  29.      Legal Stuff
  30.      Overview
  31.      Features
  32.      Requirements
  33.      Installation
  34.      Configuration
  35.      Usage
  36.      History
  37.      Updates
  38.      Contacts
  39.      Acknowledgements
  40.      Greetings & Messies
  41.  
  42.  
  43. LEGAL STUFF
  44. ===========
  45.  
  46.      This Tool and its associated Files except for all Libraries and the
  47.      Move Command are Copyright (C)1994 by Fate/Logic. All Rights reserved.
  48.      Freely usable. Any Changes to the Program except for Configuration are
  49.      strictly forbidden. I'm not responsible for any Damage done to your
  50.      System caused directly or indirectly by this Program. No Warranty is
  51.      given for the the Correctness of my English :-)
  52.  
  53.      The reqtools.library is Copyright (C)1991-1994 by Nico François
  54.      and is non-crippled Shareware. You can reach the Author at
  55.      2:292/603.10 or nico@augfl.be or by Snail-Mail at Nico François,
  56.      Corbielaan 13, B-3060 Bertem, Belgium. He prefers EMail.
  57.  
  58.      The rexxreqtools.library is Copyright (C)1992-1994 by Rafael
  59.      D'Halleweyn. You can reach the Author at rdhall@rug.ac.be or
  60.      by Snail-Mail at Rafael D'Halleweyn, Perckhoevelaan 17,
  61.      B-2610 Antwerpen, Belgium.
  62.  
  63.      The Move Commando was written by Kai Iske on 16.8.94 and is
  64.      Public Domain. You can reach the Author at kai@iske.asdp.sub.org
  65.      or iske@informatik.uni-frankfurt.de, via IRC at kiske, via the
  66.      german Zerberus Netz at KAI@SWEET.ZER or by Snail-Mail at Kai Iske,
  67.      Brucknerstrasse 18, 63542 Hanau, Germany.
  68.  
  69.      AmiExpress is (C) Lightspeed Technologies.
  70.  
  71.  
  72. OVERVIEW
  73. ========
  74.  
  75.      Galledis was created to ease putting Files online. It is a CNet
  76.      Implementation of AmiExpress' Local Upload, but with many more
  77.      Features.
  78.  
  79.      Imagine you just downloaded Tons of Files and want to put 'em
  80.      online. Up to now you need a DirTool to copy/move the Files and
  81.      you need to know where the appropiate directory is. With Galledis
  82.      you log in, enter the UDBase and at the right prompt you start
  83.      Galledis. A reqtools.library Requester will pop up asking you for
  84.      the Files to be copied/moved. If you're ready, Galledis will do the
  85.      Work for you and, new in v1.30, optionally auto-adopt the first File.
  86.  
  87.      But that's not all. Galledis is extremely configurable to your Needs
  88.      (also for run-time through Command Line Arguments) and it supports
  89.      multiple UDBase Partitions.
  90.  
  91.  
  92. FEATURES
  93. ========
  94.  
  95.      + NEW: AUTO-adopting of first File possible
  96.      + NEW: Can display Configuration used
  97.      + NEW: Overriding of Port Restriction possible
  98.      + NEW: German Documentation
  99.  
  100.      + The first and only Local Upload utility for CNet
  101.      + Extremely configurable without external Configfile
  102.      + Command Line Parser (? supported) allowing Run-time Configuration
  103.      + Supports multiple UDBase Partitions
  104.      + Ask Mode
  105.      + Takes Advantage of reqtools.library's excellent Requesters
  106.      + File Requester can open on CNet's Screen
  107.      + No bad programming - highly optimized, unstolen Code
  108.      + Easy to use
  109.  
  110.  
  111. REQUIREMENTS
  112. ============
  113.  
  114.      Galledis requires:
  115.      + reqtools.library by Nico François
  116.      + rexxreqtools.library by Rafael D'Halleweyn
  117.      + Move by Kai Iske
  118.      + CNet 3.05c
  119.  
  120.      I tested Galledis with reqtools.library Version 38.1092,
  121.      rexxreqtools.library 37.71, Move 1.10 and CNet 3.05c.
  122.  
  123.      Galledis will *not* work on CNet 2.63, e.g. due to changed GetUser
  124.      Values! On request I might do you the favour and convert them.
  125.  
  126.  
  127. INSTALLATION
  128. ============
  129.  
  130.      Just execute the supplied Script File "Install" or install by hand:
  131.      - copy Move to C:
  132.      - copy reqtools.library and rexxreqtools.library to Libs:
  133.      - copy Galledis to PFiles:
  134.  
  135.      No matter whether you choose the lazy or the manual Way, you'll still
  136.      have to add a new Entry to Section 4 of your BBSMenu File which starts
  137.      Galledis. Don't forget to restrict Access.
  138.  
  139.      If you're a novice CNet Sysop: Start your favourite Text Editor
  140.      and load the File 'CNet:bbsmenu'. Scroll down to the End of Section 4
  141.      (UDBase) and add the following Line:
  142.  
  143.      <TAB>LUP |#0PFiles:Galledis} |`31
  144.                ^
  145.                `-- This is a CTRL-Q Character, ASCII Code 17!
  146.  
  147.      Notice the `31 at the End. ` initates a List of Access Groups which
  148.      are allowed exclusively to run the Tool. So if you have a CoSysop with
  149.      Access Level 30 you would write `30,31.
  150.  
  151.      Of course you can change LUP to what you want as long as it's not
  152.      already used in the File.
  153.  
  154.      Also don't forget to change the Path if you installed Galledis
  155.      somewhere else. If you used the Install Script PFiles: is the right
  156.      Location.
  157.  
  158.  
  159. CONFIGURATION
  160. =============
  161.  
  162.      + Show Run-Time Configuration? (Variable: showconfig)
  163.        If 1, everytime you're running Galledis you're informed which
  164.        Settings apply NOW you're running it. If 0, you're not :).
  165.        Default is 1. Command Line Form: Cx.
  166.  
  167.      + Operation Mode (Variable: opmode)
  168.        If you want Galledis to copy _all_ Files, set this to 0. If you
  169.        want Galledis to move _all_ Files, set this to 1. Setting 2
  170.        enables Ask Mode which asks you for every File whether to copy,
  171.        move or to abort.
  172.        Default is 2. Command Line Form: Mx.
  173.  
  174.      + Default Path for the Requester (Variable: reqpath)
  175.        This is the Path the ReqTools Filerequester will scan first.
  176.        Usually this will be your Up- and Downloads Directory.
  177.        If you use this from the Command Line do *NOT* use any Spaces !!!
  178.        Default is 'DH0:'. Command Line Form: Rx.
  179.  
  180.      + Flush Requester Buffers? (Variable: reqflush)
  181.        ReqTools features an internal Directory Cache. If you used Galledis
  182.        once and start it again the Requester will remember the previous
  183.        Contents. If you want to disable this Cache, set this to 1 (Yes),
  184.        else specify 0 (No).
  185.        Default is 0. Command Line Form: Fx.
  186.  
  187.      + Open Requester on CNet's Screen? (Variable: reqscreen)
  188.        If you want the Requester to be opened on the Screen you started
  189.        Galledis from set this to 1 (Yes), else specify 0 (No).
  190.        Default is 1. Command Line Form: Sx.
  191.  
  192.      + Partition Select? (Variable: partselect)
  193.        If you have one UDBase0: Assign, set this to 0. Or to 1, if you
  194.        want Galledis to display you where the Files will be copied or
  195.        moved to. If you have several UDBase Partitions, set this to 2
  196.        to enable Partition Select.
  197.        Default is 1. Command Line Form: Px.
  198.  
  199.      + Default Partition (Variable: defpart)
  200.        Only required if you set partselect to 2.
  201.        Default is 0.
  202.  
  203.      + Override Password (Variable: override)
  204.        Password to override Port Restriction. See below for more Info.
  205.        Don't use ALT or CTRL Characters!
  206.        Default is "".
  207.  
  208.      + Log Override Attempts? (Variable: logoverride)
  209.        Should Galledis log Override Attempts? 0=No, 1=Yes, 2=Full.
  210.        See below for more Info.
  211.        Default is 2.
  212.  
  213.      + Auto-adopt Files? (Variable: autoadopt)
  214.        Should Galledis auto-adopt the first File? 0=No or 1=Yes.
  215.        See below for more Info.
  216.        Default is 1.
  217.  
  218.      + Adopt Orphans Command (Variable: aocommand)
  219.        Some Sysops may have localized their system heavily...
  220.        put the Command you use in the BBSMenu File here.
  221.  
  222.      As you have seen some Options have a Command Line Form. You can append
  223.      one or several of these Options seperated by Space behind the Command
  224.      you used to call Galledis. The Order doesn't matter.
  225.  
  226.      You needn't check this Docfile all the Time just to see what the
  227.      Command Line Form of an Option is. Run Galledis with "?" and you'll
  228.      get Online Help, just like with Shell Commands.
  229.  
  230.      If you disabled Display of Configuration and you just want to see it
  231.      once, the Argument "C" will show it.
  232.  
  233.      Note that the last two Arguments will cause Galledis to exit immediately
  234.      after finishing their jobs.
  235.  
  236.      Another Argument for the Command Line is "O" which forces Galledis
  237.      to override Port Restriction. Normally Galledis can be run from a
  238.      local Port only. If you for any Reason want to disable this Check
  239.      specify Option "O" and enter the Password you specified in the
  240.      variable override. If you set logoverride to 2, all Attempts to
  241.      override are logged, if 1 only failed ones. Leave override empty
  242.      to disable overriding at all.
  243.  
  244.      Last not least about the Auto-adopting. v1.30 goes a Step further
  245.      than in previous Versions. You needn't know the first Filename
  246.      anylonger. I already hear you saying "Amazing Feature"... it is
  247.      simply not possible to auto-adopt ALL Files !!! I don't want to
  248.      explain it here, if you're an advanced coder, you'll know why.
  249.  
  250.  
  251. USAGE
  252. =====
  253.  
  254.      Some Examples for valid Command Strings:
  255.  
  256.      LUP ?
  257.      LUP M2 RHD1: P0
  258.      LUP S1 RDF0: C
  259.      LUP F1
  260.  
  261.      Invalid Command Strings:
  262.  
  263.      LUPM0          will cause CNet not to recognize the LUP Command
  264.      LUP RHD1:P1    will make the Requester ask for "HD1:P1"
  265.      LUP F1S1       will make Galledis ignore the Argument as it's not
  266.                     supported
  267.      LUP F3         will make Galledis print an Error Message because
  268.                     the F Argument accepts 0 or 1 as Parameter only
  269.  
  270.      The overall Usage of Galledis is pretty easy and does not need to
  271.      be explained, does it?
  272.  
  273.      Please refer to the reqtools.library's Manuals for how to use
  274.      the Requester (if you need to). Multi-Selection of Files is done
  275.      by clicking on the first File, then, while holding the SHIFT Key,
  276.      clicking on the other Files.
  277.  
  278.      For Usage of the Move Commando type 'Move ?' or check its Docfile.
  279.  
  280.  
  281. HISTORY
  282. =======
  283.  
  284.      v1.21          16 September 1994 - Public Release
  285.                     Move Routine now also works when moving from different
  286.                     Devices. Also added Partition Select.
  287.  
  288.      v1.22          21 September 1994 - Internal Release
  289.                     Added "Override Port Restriction" Feature.
  290.  
  291.      v1.23          24 September 1994 - Internal Release
  292.                     Added Display of current Configuration.
  293.  
  294.      v1.24          26 September 1994 - Internal Release
  295.                     Added more Checks to enforce Usage from Subboards
  296.                     only - if you chose the wrong BBSMenu Area.
  297.  
  298.      v1.30          3 October 1994 - Public Release
  299.                     Added Posibility to auto-adopt the first File
  300.                     Added German Documentation.
  301.                     Hmm, I'd rather say: translated in a hurry ;)
  302.  
  303.  
  304. UPDATES
  305. =======
  306.  
  307.      New Versions of Galledis and other CNet Tools by Logic will be available
  308.      through various medias. You should take a Look at AmiNet's comm/bbs/cnet
  309.      Directory as well as your local BBSes. Galledis is also FTPable from
  310.      bkroom.apana.org.au, in the directory /pub/amiga/comm/cnet/. Furthermore
  311.      Galledis is FIDO FREQable from Frontiers BBS, Buffalo, NY (1:260/121).
  312.      Members of the UUCP Mailing List will get new Updates automatically as
  313.      long as the File Size stays reasonable. Last not least you can download
  314.      it directly from any of the Boards listed below.
  315.  
  316.  
  317. CONTACTS
  318. ========
  319.  
  320.      If you have any Questions, Suggestions or just need somebody to write
  321.      to about Things like Music, Girls or whatever you like:
  322.  
  323.      InterNet     : fate@flory.rhein-main.de
  324.      Fido Classic : fate@2:2465/334.1
  325.      Fido Lite    : fate@2:244/1544.1
  326.      AmigaNet     : fate@39:172/3.1
  327.  
  328.      If you do not have Access to these Networks you can also contact me at
  329.      the Indians Home BBS located in Oberursel, Germany. The Numbers are
  330.      06171-268340, 06171-926259 and 06171-926180 and will lead you to
  331.      Yoriko VFast Modems. I'm also reachable at "The Addiction" and the
  332.      "Digital World", both being located in Germany or at "Future World".
  333.  
  334.  
  335. ACKNOWLEDGEMENTS
  336. ================
  337.  
  338.      Thanks for Beta Testing and Bug Reports:
  339.      - Terry Wood
  340.      - Dave Lawley
  341.  
  342.      Also Thanks to Nico François and Rafael D'Halleweyn for their cool
  343.      Work (ReqTools/RexxReqTools). Everyone should consider registering!
  344.      Furthermore thanks to Marlin Schwanke and Terry Wood for managing
  345.      the UUCNet Mailing List. And Thanks to Jamie Lovick and David Weeks
  346.      for making Galledis available through FTP and Fido FREQ.
  347.  
  348.  
  349. GREETINGS & MESSIES
  350. ===================
  351.  
  352.      - Red Hawk/Interactive   Geht schon, oder?
  353.      - Quickfinger/Shoot      Go on SHOOTing!
  354.      - Red Alert              Mein Bier...
  355.      - -Vindex!               Was geht?
  356.      - Shadow Man             Best Wall seen so far!
  357.      - Calypso/GOD^Logic      CNet rulez!!!
  358.      - Ace/Logic              Immer korrekte Messies!
  359.      - Amo/Osiris             Bist du jetzt online oder nicht?!
  360.      - Snow                   Da haste deine deutsche Anleitung ;)
  361.  
  362.      - Overlord/Skid Row      Wat is er met je BBS aan de hand ?!
  363.      - Whirlwind/Dutch Dreams Mooie Ansis !!!
  364.  
  365.      - Cayliph/S!+EX4         Why didn't ya just send a Mail to QF ??!!
  366.                               Read the Docs first !!!
  367.      - Terry Wood             Will ya ever reach me ? ;)
  368.      - Ivan Wheelwright       Sorry, can't find this damned UUCP Flag!
  369.  
  370.               Also Greets to all I didn't mention here e.g.:
  371.    X-Ray/Interactive, Shodan/Interactive, Lord Chaos, Beeblebrox/Osiris,
  372.       MuMu/Osiris, Trooper/Osiris, Spider/Osiris, Masterbyte/Osiris,
  373.      Ace/Logic^Osiris, Steve/Logic, Mean Max/PDY, Mike & Dave/Classic,
  374.          Euronymous/TRSI^TT, Geronimo, Maverick, Rio, Snow, /X\ac,
  375.             Marky/Backlash, Power/Backlash and all Users of the
  376.                UUCNet Mailing List. (of course in no Order)
  377.  
  378.                                     ---
  379.  
  380.                      Join the UUCP CNet Mailing List!
  381.             An InterNet EMail Forum for CNet Sysops worldwide!
  382.  
  383.         Send an EMail to uucnet-request@cnet577.cts.com containing
  384.                   SUBSCRIBE <your InterNet EMail Address>
  385.           If you have any Questions, contact the Administrator at
  386.                        uucnet-admin@cnet577.cts.com
  387.  
  388.                                     ---
  389.  
  390.                 Coming up from Fate/Logic CNet Innovation:
  391.                              FateComment v3.0
  392.                                FrontEnd v1.0
  393.  
  394.                     Perhaps these will be written in C,
  395.                  depends on how long I take to learn this
  396.                             damned Language ;-)
  397.  
  398.  
  399.  
  400.                                 - The End -
  401.                        Forward ever, backward never!
  402.  
  403.                             
  404.  
  405. ------------------------------------------------------------------------>>
  406.             <·> PROFESSIONAL TOOLS FOR PROFESSIONAL SYSOPS! <·>
  407. <<------------------------------------------------------------------------
  408.